home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / EXP_DXF.1 < prev    next >
Encoding:
Text File  |  1996-06-13  |  4.5 KB  |  100 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Export-DXF
  3. .SH NAME
  4. exp_dxf \- AutoCAD DXF geometry export filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the AutoCAD DXF geometry
  8. export converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert a 3D Studio file to DXF using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i 3ds -o dxf filename.3ds
  16. .PP
  17. To convert a Lightwave file to DXF and override some of the default options 
  18. in setup.ini:
  19. .IP
  20. pt -i lw -o dxf -out-dxf-entity-type = 3dface filename.lw
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. The AutoCAD DXF geometry export converter writes out the scene database
  25. as either 3-point or 4-point polygons using the 3DFACE or POLYFACE MESH
  26. entities. Polygons with 5 or more vertices, concave polygons, or polygons 
  27. with holes are automatically triangulated. Only ENTITIES are output, no 
  28. BLOCKS. All polygons will be assigned DXF color # 1.
  29. .PP
  30. If the file is written using the POLYFACE MESH option then there is no
  31. need to weld the geometry data when the DXF file is read into another
  32. program (since the data output to the DXF file will be automatically 
  33. welded by this converter).
  34. .PP
  35. If the data is output using the POLYFACE MESH option then it can be 
  36. stretched, rotated, scaled and moved within AutoCAD using the PEDIT command 
  37. but the data cannot be edited directly. To edit the faces, use the EXPLODE 
  38. command in AutoCAD to break the mesh into separate 3D Face entities.
  39. .PP
  40. .SH COMMAND LINE OPTIONS
  41. .PP
  42. The following options are specific to this export converter:
  43. .TP
  44. -o dxf
  45. This is the mandatory command line option which specifies that the data
  46. is to be exported using the DXF format converter.
  47. .TP
  48. -out-dxf-reverse-poly = [ yes | no ]
  49. If set to 'yes' then the orientation of all polygons will be reversed before
  50. being output; this
  51. might be necessary if the destination program which will read in the DXF
  52. file uses a different polygon orientation. The default is 'no'.
  53. .TP
  54. -out-dxf-force-triang = [ yes | no ]
  55. If set to 'yes' then all data will be output as triangles. The default
  56. is 'no'.
  57. .TP
  58. -out-dxf-layer-mode = by-object-name | by-surface-name | one-layer
  59. This option determines which DXF layer each polygon will be assigned to.
  60. .IP
  61. The 'by-object-name' option (which is the default) will output all polygons 
  62. that belong to the same object (ie: a sphere) to their own layer whose name 
  63. will be derived from the object's name. 
  64. .IP
  65. The 'by-surface-name' option will
  66. output all polygons which share the same surface/material definition to
  67. their own layer whose name will be derived from the surface's name.
  68. .IP
  69. The 'one-layer' option will output all polygons to a single layer named
  70. 'LAYER1'.
  71. .TP
  72. -out-dxf-entity-type = polyface-mesh | 3dface
  73. This option determines whether polygons will be exported using the DXF 
  74. 'Polyface mesh' entity or the '3D FACE' entity.
  75. .IP
  76. If set to 'polyface-mesh', which is the default, 
  77. then the polygons will be exported using the DXF Polyface Mesh (PFACE) entity. 
  78. This creates a more compact DXF file and can be read in much faster than a 
  79. file written using the 3D FACE entity. All polygons are stored in two arrays 
  80. consisting of a vertex array list and a face list. In AutoCAD you can use the 
  81. PEDIT command to  stretch, rotate, scale and move the mesh but not to edit it.
  82. To edit the faces, use the EXPLODE command to break the mesh into separate 
  83. 3D Face entities. NOTE: Files written using this entity type already have their 
  84. vertices automatically welded by the NuGraf export utility.
  85. .IP
  86. If set to '3dface' then the polygons will be exported using the DXF '3D FACE'
  87. entity. This creates much larger files since each polygon is stored to the 
  88. file one-by-one. However, most DXF reader programs can read this format so it 
  89. might be necessary to use this option if a DXF reader cannot understand the
  90. Polyface Mesh format.
  91. .TP
  92. -out-line-ending = [ cr | lf | crlf ]
  93. This common option selects which line terminator is to be used for the ASCII output 
  94. file. Files destined for DOS/PC machines should use 'crlf', files for UNIX 
  95. machines should use 'lf' and files for Macintosh machines should use 'cr'.
  96. The default is specific to which machine this converter is presently running
  97. on: 'crlf' for DOS/PC, 'lf' for UNIX and 'cr' for Macintosh. This option
  98. normally does not have to be specified unless you will be using the exported
  99. ASCII file on a different type of computer.
  100.